package cn.ecommerce.course.module.users.config;


import cn.ecommerce.course.module.users.filter.JwtAuthenticationTokenFilter;
import cn.ecommerce.course.module.users.service.security.UserDetailsServiceImpl;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.authentication.AuthenticationManager;
import org.springframework.security.config.annotation.authentication.configuration.AuthenticationConfiguration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.http.SessionCreationPolicy;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.security.crypto.password.PasswordEncoder;
import org.springframework.security.web.SecurityFilterChain;
import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter;
import org.springframework.security.web.util.matcher.AntPathRequestMatcher;
import org.springframework.web.cors.CorsConfiguration;
import org.springframework.web.cors.CorsConfigurationSource;
import org.springframework.web.cors.UrlBasedCorsConfigurationSource;

import javax.annotation.Resource;
import java.util.Arrays;

/**
 * Spring Security 核心配置类
 * 负责配置认证授权规则、CORS跨域、JWT过滤器等安全相关配置
 */
@Configuration  // 标识为配置类，让Spring容器扫描并加载
@EnableWebSecurity  // 启用Spring Security的Web安全支持
public class SecurityConfig {

    /**
     * 注入自定义的用户详情服务实现类
     * 用于从数据库或其他数据源加载用户信息（用户名、密码、权限等）
     */
    @Resource
    private UserDetailsServiceImpl userDetailsService;

    /**
     * 注入JWT认证过滤器
     * 用于拦截请求并验证JWT令牌的有效性
     */
    @Resource
    private JwtAuthenticationTokenFilter jwtAuthenticationTokenFilter;

    /**
     * 密码加密器Bean定义
     * BCryptPasswordEncoder是Spring Security推荐的密码加密算法
     * 它会自动生成随机盐值，每次加密结果都不同，但可以验证原始密码
     */
    // @Bean
    // public PasswordEncoder passwordEncoder() {
    //     return new BCryptPasswordEncoder();
    // }

    /**
     * 认证管理器Bean定义
     * AuthenticationManager是Spring Security的核心认证管理器
     * 负责处理认证请求（如用户名密码登录）
     */
    @Bean
    public AuthenticationManager authenticationManager(AuthenticationConfiguration config) throws Exception {
        // 从AuthenticationConfiguration中获取默认的AuthenticationManager
        return config.getAuthenticationManager();
    }

    /**
     * 安全过滤器链配置
     * SecurityFilterChain是Spring Security 5.7+推荐的配置方式
     * 用于定义安全规则、请求授权、会话管理等核心安全配置
     */
    @Bean
    @org.springframework.core.annotation.Order(200) //设置优先级，免被用户端链或兜底链误接管。
    public SecurityFilterChain appSecurityFilterChain(HttpSecurity http) throws Exception {
        // 只处理以"/app-api"开头的请求
        http.securityMatchers(matchers -> matchers.requestMatchers("/app-api/**"));

        http
                // 1. 禁用CSRF保护
                // 原因：前后端分离项目中，前端通常不存储Session，而是使用JWT令牌
                // CSRF依赖Session，因此在无状态认证中可以禁用
                .csrf(csrf -> csrf.disable())

                // 2. 配置CORS跨域支持
                // 指定使用自定义的CORS配置源
                .cors(cors -> cors.configurationSource(corsConfigurationSource()))

                // 3. 配置会话管理策略
                // STATELESS：无状态模式，不创建也不使用Session
                // 适合JWT认证，服务器不存储会话信息，所有状态通过令牌传递
                .sessionManagement(session -> session.sessionCreationPolicy(SessionCreationPolicy.STATELESS))

                // 4. 配置请求授权规则
                .authorizeHttpRequests(auth -> auth
                        // 配置允许匿名访问的接口（不需要登录就能访问）
                        .requestMatchers(
                                new AntPathRequestMatcher("/app-api/users/accountLogin"),
                                new AntPathRequestMatcher("/app-api/users/verifyCodeLogin")
                        ).permitAll()
                        // 其他所有请求都需要认证（登录后才能访问）
                        .anyRequest().authenticated()
                )

                // 5. 配置自定义的用户详情服务
                // 告诉Spring Security使用我们自定义的UserDetailsService来加载用户信息
                .userDetailsService(userDetailsService)

                // 6. 添加JWT过滤器
                // 在UsernamePasswordAuthenticationFilter之前执行JWT过滤器
                // 目的：先验证JWT令牌，如果有效则直接设置认证信息，无需再走用户名密码认证流程
                .addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class);

        // 构建并返回SecurityFilterChain实例
        return http.build();
    }

    /**
     * CORS跨域配置源
     * 定义跨域请求的规则，如允许的源、方法、请求头等
     */
    @Bean
    public CorsConfigurationSource corsConfigurationSource() {
        // 创建CORS配置对象
        CorsConfiguration configuration = new CorsConfiguration();

        // 设置允许的源（前端域名）
        // "*"表示允许所有源，实际生产环境应指定具体的域名（如http://localhost:8080）
        configuration.setAllowedOriginPatterns(Arrays.asList("*"));

        // 设置允许的HTTP方法
        configuration.setAllowedMethods(Arrays.asList("GET", "POST", "PUT", "DELETE", "OPTIONS"));

        // 设置允许的请求头
        // "*"表示允许所有请求头，包括自定义头（如Authorization）
        configuration.setAllowedHeaders(Arrays.asList("*"));

        // 是否允许携带凭证（如Cookie）
        configuration.setAllowCredentials(true);

        // 创建URL基于的CORS配置源
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        // 对所有路径应用上述CORS配置
        source.registerCorsConfiguration("/**", configuration);

        return source;
    }
}
